home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 September / CHIP Eylül 1998.iso / freeware / Image00 / README.TXT < prev   
Text File  |  1997-03-17  |  13KB  |  284 lines
  1.                           ImageGen for Windows 95
  2.  
  3.                         Written By Robert Thivierge
  4.  
  5.                  Program File Version Date: March 17, 1997
  6.  
  7. WARNING: READ THIS WHOLE PAGE BEFORE RUNNING IMAGEGEN!!!
  8.  
  9. ImageGen is a freeware Windows 95 program that produces HTML Web pages
  10. consisting of small in-line JPEG or GIF images. These images can be clicked
  11. on in a Web browser (like Netscape) to see the full sized JPEG or GIF
  12. picture. It also creates clickable icons that link to files of any type.
  13. ---------------------------------------------------------------------------
  14.  
  15. This document is on the web at http://www.canuck.com/~thivier1/imagegen and
  16. is a plain text file (called README.TXT), which is included with ImageGen.
  17.  
  18. Table of Contents
  19.  
  20.    * ImageGen News
  21.    * Sample Sites
  22.    * Current Features
  23.    * Planned Features
  24.    * Legal Issues and Credits
  25.         o Ownership
  26.         o Freeware Status
  27.         o Credits
  28.         o Disclaimer
  29.    * System Requirements
  30.    * Downloading and Installing
  31.    * Bugs
  32.    * Known Potential Problems
  33.    * Contacting the Author
  34.  
  35. ImageGen News
  36.  
  37. Due to bugs in recent releases I have fallen behind in responding to
  38. e-mail. If you find that I don't respond to your e-mail within a month,
  39. please re-read this page, follow all instructions, and try one or two more
  40. times. Also, remember, it's your responsibility to repeat all *required*
  41. information in *every* e-mail, while still remaining short and concise.
  42. Remember, it's my choice to decide who I wish to assist. I only help people
  43. who help me make ImageGen a better program.
  44.  
  45. ImageGen has been changed so that when you click on a item in the opening
  46. screen a description of the item is displayed at the bottom of the screen.
  47. Also, many cryptic names of settings have been given more meaningful names.
  48. This should make the program easier for new users. For older users, all the
  49. existing functionality is the same, but it may take some time to get used
  50. to the changes.
  51.  
  52. Sample Sites
  53.  
  54. There are scores of sites and hundreds of pages made with ImageGen. I have
  55. made a very tiny sample page here. The best search engines to find ImageGen
  56. sites are HotBot, Excite, and Alta-Vista. Search for the word "imagegen" in
  57. all lower-case letters. If you know of another search engine that produces
  58. good results (ie. hundreds of ImageGen pages), please let me know.
  59.  
  60. Current Features
  61.  
  62. Web Features
  63.  
  64.    * For every JPEG or GIF file in your site, it creates a smaller JPEG or
  65.      GIF thumbnail version, which the browser user can click on to see the
  66.      full sized version.
  67.    * Other file types are shown using an icon appropriate to the file type,
  68.      along with the file type name. Browsers of your pages can download any
  69.      file of any type.
  70.    * You can make a single page site, or a multi-page/multi-level site.
  71.    * Enter descriptive text about each images while seeing preview of
  72.      image.
  73.    * Images can optionally be grouped based in similiarity in file names.
  74.    * All text outputted in pages can be changed.
  75.    * Works with pictures on CD-ROM.
  76.    * You can visually select a background color, use Windows wallpaper as a
  77.      background image, or select your own JPEG/GIF background image.
  78.    * You can choose in the Layout Wizard how many images to show in each
  79.      row of a table.
  80.    * The Layout Wizard can generate "Detail Pages", which allow browser
  81.      users to see extra info about each picture that might not fit on the
  82.      Index Page. Also, each Picture Detail Page is directly linked to the
  83.      first, previous, next, and last Picture Detail Page.
  84.    * Instead of having all the pictures in a folder appear on one page,
  85.      ImageGen can (optionally) break them up into groups with similiar file
  86.      names.
  87.    * When downloading the full sized version of an image, a browser user
  88.      can (if you want) instantly see a full sized low resolution version of
  89.      the image. It is then progressively replace by a higher reslution
  90.      version.
  91.  
  92. If there's anything you can't get ImageGen to do when making Web Pages,
  93. please let me know.
  94.  
  95. Planned Features
  96.  
  97.   1. Creation of GIF or JPEG in-line/preview images for all file types,
  98.      created by programs that are 100% Windows 95 and OLE 2.0 compliant
  99.      (ie. Microsoft Office 95).
  100.   2. 100% visual user interface.
  101.   3. JavaScript and Java support.
  102.   4. Client Side Image Maps.
  103.  
  104. Legal Issues and Credits
  105.  
  106. Ownership
  107.  
  108. ImageGen(c) 1997
  109. The Picture Page Generator
  110. Written by Robert Thivierge
  111. All rights reserved by Robert Thivierge
  112.  
  113. Any attempt by a person other than myself to reverse compile, sell, or to
  114. represent the program as their own is prohibited. You may give a copy of
  115. the the program to someone else free of charge, provided you include all
  116. the files you received yourself. They then should notify me of receipt of
  117. it.
  118.  
  119. Legal use of my program requires that I be notified that you are using it
  120. and be able to see any web pages made with it. This means I should be sent
  121. the URL of any ImageGen derived web pages. If a username/password is
  122. required simply to view the site, than I must be given it. If this is not
  123. acceptable to you (or whoever makes the relevent decisions) than you may
  124. not use my software.
  125.  
  126. Any person or organization may distribute my program as freeware. They may
  127. charge a fee for the service of distribution (such as on-line charges,
  128. charge for distribution media, etc...). An acceptable form of distribution
  129. is including my program on CD-ROMs containing freeware/shareware, where
  130. there is a charge for the CD-ROM. However, it must be understood that they
  131. are not selling my program. And absolutely nobody, but me, may imply or
  132. suggest that they authored this program or that it is their property. I
  133. must always be given full credit.
  134.  
  135. I must be notified when my program is included on CD-ROM.
  136.  
  137. Legal Credits
  138.  
  139.    * This software is based in part on the work of the Independent JPEG
  140.      Group. They are kind enough to allow programmers to use their code
  141.      library without financial charge.
  142.    * The Graphics Interchange Format(C) is the Copyright property of
  143.      CompuServe Incorporated. GIF(SM) is a Service Mark property of
  144.      CompuServe Incorporated.
  145.    * The actual compression method used in GIF is copywrited by Unisys
  146.      Corporation. I thank them for allowing freeware authors to use their
  147.      compression method without obtaining a license or paying royalties.
  148.      See the Unisys FAQ on GIF for further details.
  149.  
  150. Disclaimer
  151.  
  152. Use my program at your own risk. There are bugs I know of, there are bugs I
  153. don't know of. I assume no liability for any losses incurred by use of my
  154. program. I myself have accidently overwritten files with ImageGen. So, if I
  155. can loose stuff, you can too. In fact, some users have lost files and been
  156. unable to recover.
  157.  
  158. System Requirements
  159.  
  160.    * Operating System: Windows 95 or Windows NT 4.0 or better
  161.    * Processor: 80486 or better
  162.    * Memory: 32 Megs or better
  163.  
  164. Installation Procedures
  165.  
  166. To install, do the following:
  167.  
  168.   1. Back-up everything or be prepared to loose everything. If you aren't
  169.      sure if you want to do this, then stop now and don't use ImageGen.
  170.   2. Download The ImageGen ZIP File. If you're viewing this document on the
  171.      web with Netscape you can right click on the highlighted text here,
  172.      and then select "Save Link As...".
  173.   3. Make a folder (directory) for the program (such as C:\IMAGEGEN). It is
  174.      very important that you have a directory set aside exclusively for
  175.      ImageGen. Never use the same directory for the program that you use
  176.      for your Web Site (ie. the folder where you keep all your pictures).
  177.   4. Copy the ZIP File into it.
  178.   5. Unzip it with PKUNZIP or a compatible program. Use the command:
  179.      PKUNZIP IG32.ZIP
  180.   6. Make sure all the ImageGen program files are in the same folder, with
  181.      no other files present. Never use this folder to put your pictures or
  182.      HTML files in. Remember, files in the "IMAGEGEN" folder can be
  183.      overwritten.
  184.   7. Now you can start ImageGen using the Windows Explorer. You may also
  185.      wish to create a short-cut for the program. On the desktop right click
  186.      the mouse, and select New/Shortcut.
  187.   8. To generate a site for the first time, use the "Layout Wizard" to
  188.      decide what it will look like.
  189.   9. Remember, when selecting a folder for your site, that old HTML file(s)
  190.      will be overwritten. So, please be very careful. Do not generate a
  191.      site until you've thought about what you're doing.
  192.  10. When using the "Layout Wizard", you must fill in everything on the
  193.      first screen completely. Do not skip something or make up information.
  194.  
  195. Bugs
  196.  
  197. You should report bugs to thivier1@canuck.com after reading the information
  198. below.
  199. Note: I am unable to respond to any bug reports that fail to meet the
  200. following requirements.
  201.  
  202. The latest version of ImageGen now writes out much of the information you
  203. need to report, into a special file called "igerrlog.txt". The file is in
  204. the same folder as "imagegen.exe". When reporting a bug, you should
  205. copy/paste this file to the end of your e-mail message. If it's huge, than
  206. please send me e-mail asking to send it.
  207.  
  208. Before sending me a bug report you should first carefully examine any error
  209. message you see on the screen and also look at "igerrlog.txt". Look for
  210. files that are mentioned to have problems, also look at the file name that
  211. is the last in the list, or just before (or after) where the error is
  212. printed. Use graphics viewing/editing software to fix problems in you image
  213. file(s). If you find any, you should move, fix, or delete them.
  214.  
  215. Try removing all but just a few of your images, to see if the problem
  216. continues. If the problem only occurs with a few (or one) image, than it's
  217. probably not a bug in ImageGen.
  218.  
  219. When you do send me an e-mail message, please ensure all the following is
  220. including. The file "igerrlog.txt" should contain it, but it's your
  221. responsibility to ensure it's present and correct.
  222.  
  223.    * The exact File Version Date of ImageGen you're using. This information
  224.      appears both in Help/About and in "igerrlog.txt".
  225.    * Operating System and version that you run ImageGen in.
  226.    * What (if any) network you're using.
  227.    * Exactly what lead up to the error. The word "crash" and "died" tell me
  228.      nothing useful. I want to know how it happened, and exactly what
  229.      happened. Under what circumstances does it run OK? Have you tried
  230.      running it with different pictures that you know are error free? Did
  231.      you try doing a fresh re-install.
  232.    * The exact text of any error message. If a file name or line number is
  233.      reported, this information is critical.
  234.    * Send the URL of your web site. If it's private, send any user
  235.      name/password required to access it. People who send requests for
  236.      help, but forget this, get put at the bottom of my help list. If you
  237.      don't have a URL (ie. it's not ready yet), then please say so. Of
  238.      course, some people won't have a working web site until after they fix
  239.      a problem with ImageGen.
  240.  
  241. There are many users who contact me, so always repeat important
  242. information. Don't assume I'll remember anything from the past. Reminding
  243. me of a URL, is also a good idea.
  244.  
  245. Bug List
  246.  
  247.    * ImageGen sometimes has a problem with video modes other than 8-bit and
  248.      24-bit color. If this occurs try using 8-bit color video mode.
  249.    * Sometimes ImageGen doesn't cancel when told to. Often, repeatedly
  250.      hitting the "Cancel" button is required.
  251.    * Changes to site layout can not always be saved.
  252.    * When selecting a folder using a dialog box, ImageGen crashes if you
  253.      try to select the special Windows 95 "My Computer" folder.
  254.  
  255. Known Potential Problems
  256.  
  257. Please be advised certain actions taken in ImageGen have massive and
  258. permanent consequences, for which users (ie. you) and not me, are 100%
  259. liable for. A list of only some (not all) of these follows. Always back up
  260. everything, before using ImageGen. Remember, I am not responsible for any
  261. problems you have with ImageGen.
  262.  
  263.    * ImageGen can create a very large number of files automatically. It
  264.      creates in-line image files (*.jpg,*.gif), web pages (*.htm), cache
  265.      image files (*.bmp), and sub-directories, as needed. Sometimes a file
  266.      may no longer be needed, it's your responsibility to periodically
  267.      clean-up up your hard disk.
  268.    * When writing files, ImageGen will overwright existing files of the
  269.      same name. In particular ImageGen always creates a file called
  270.      index.htm (or index.html). People often already have a file with this
  271.      same name. Make sure you don't already have a file of the same name.
  272.    * ImageGen creates Sub-Folders called "cache" which stores BMP files.
  273.      These are intermediate work files that ImageGen uses. They can take an
  274.      enormous amount of space. It's your responsibility to periodically
  275.      delete this files. ImageGen never will.
  276.  
  277. Contacting the Author
  278.  
  279. You are welcome to contact me with your comments, suggestions, and bug
  280. reports at thivier1@canuck.com. If it's a bug report, please read this
  281. whole page first.
  282.  
  283. Visit my Home Page at http://www.canuck.com/~thivier1
  284.